home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / PROGRAM / TON_O_C.ARJ / SPLINE.DOC < prev    next >
Text File  |  1992-01-02  |  5KB  |  136 lines

  1. To: info-ibmpc@usc-isib.ARPA
  2. Subject: contribution to library
  3. Date: Sat, 17 May 86 17:18:28 -0500
  4. From: James R. Van Zandt <jrv@mitre-bedford.ARPA>
  5.  
  6. I'd like to submit this program to the library.
  7. -------------------------------------------
  8.  
  9. SPLINE.C    Generates splines under tension and allows general curves
  10.             and multiple independent curves in the same file.  Text
  11.             input and output files like the UNIX program.  Written in
  12.             C by J. R. Van Zandt, based on algorithms by A.  K.  Cline.
  13.             (jrv@mitre-bedford)  May 17, 1986
  14. ------------------------------------------------------------
  15. NAME
  16.     spline - interpolate using splines under tension
  17.  
  18. SYNOPSIS
  19.     spline [file] [options]
  20.  
  21. DESCRIPTION
  22.     Without options, SPLINE reads pairs of numbers (x- and y-values) from
  23.     the standard input (or the given file), generates a smooth curve
  24.     through the points, and writes to the standard output points from the
  25.     smooth curve.  The curve is a spline under tension (see references),
  26.     which is somewhat "tighter" than a cubic spline, and less likely to
  27.     have spurious inflection points.  As with GRAPH, each pair of points
  28.     may optionally be followed by a comment.  If the comment is surrounded
  29.     by quotes "...", it may contain spaces.  The given points, and
  30.     their comments if any, will be included in the output.
  31.  
  32.     Input lines starting with ";" are written to the beginning of
  33.     the output file but are otherwise ignored.  Blank lines are
  34.     ignored.
  35.  
  36.     If the -c switch is not used, the input points must be from a function
  37.     - that is, the x values must be strictly increasing.  The
  38.     output points will also be from a function.  (If the -b switch
  39.     is used, this restriction applies only within each segment.)
  40.  
  41.     If the -c switch is used (indicating a general curve), the
  42.     input points need not be from a function, but each pair of
  43.     points must be separated from the previous pair by a finite
  44.     distance.  (If the -b switch is used, this restriction applies
  45.     only within each segment.)
  46.     
  47. options are:
  48.   -a  [step [start]] Input data contains only y values - generate automatic
  49.           abscissas at intervals of step (default 1) starting at start
  50.           (default 0).
  51.  
  52.   -b         break the interpolation at each label.  That is, the input
  53.         curve is divided into sections with the last point in
  54.         each section marked by a label (which may be empty:
  55.         "").  A separate interpolating curve is to be found for
  56.         each section.  In this case, the requirements on the
  57.         number of intervals (specified by the -n switch or
  58.         defaulted) and the interpolation range (specified by the 
  59.         -x switch) are applied to each section independently.
  60.  
  61.   -c            general curve rather than function.  In this case, the curve
  62.           is parameterized on the polygonal arclength from the
  63.           first to the last given point, with the whole length
  64.           scaled to be 1.  Thus, the values min and max for the
  65.           -x switch should satisfy 0 <= min < max <= 1.
  66.  
  67.   -n  num       interpolate over num intervals (default is 100)
  68.  
  69.   -t num    Specify tension in interpolating curve.  Tension of 50 gives
  70.         almost polygonal line, tension of .01 gives almost cubic
  71.         spline.  Default is 1.
  72.  
  73.   -x [min [max]]   interpolate from min to max only.  min and max should be in
  74.         the range of the given x values, except that if the -c switch
  75.         is used they should satisfy 0 <= min < max <= 1.
  76.  
  77.   -xl        take log of x values before interpolating, take exponential
  78.            afterwards (probably necessary if -xl switch is needed for
  79.            GRAPH)
  80.  
  81.   -yl        take log of y values before interpolating, take exponential
  82.            afterwards (probably necessary if -yl switch is needed for
  83.            GRAPH)
  84.  
  85. NOTES
  86.     Similar to the Unix routine, except using splines under tension,
  87.     passing labels through, and allowing general curves.
  88.  
  89. REFERENCES
  90.  
  91.     A.  K.  Cline, "Scalar- and Planar- Valued Curve Fitting Using
  92.     Splines Under Tension", Communications of the ACM v 17 n 4 p
  93.     218-223 (Apr 74).
  94.  
  95.     Schweikert, D.  G.  "An interpolation curve using a spline in
  96.     tension", J.  Math.  and Physics v 45 p 312-317 (1966).
  97.  
  98. AUTHOR
  99.     Copyright (c) 1985  James R. Van Zandt
  100.  
  101.     Resale forbidden, copying for personal use encouraged.
  102.  
  103. ------------------------------------------------------------
  104. /*    spline - interpolate points in a tabulated function or curve
  105.  
  106.     Usage...
  107.         spline [file][options]
  108.         options are:
  109.           -a  [step [start]] automatic abscissas 
  110.           -b                 break interpolation at each label
  111.           -c                 general curve 
  112.           -n  num            interpolate over num intervals 
  113.           -t  num            tension in interpolating curve 
  114.           -x  [min [max]]    interpolate from min to max 
  115.  
  116.     Notes...
  117.         This program fits a smooth curve through a given set of points,
  118.         using the splines under tension introduced by Schweikert [J. 
  119.         Math.  and Physics v 45 pp 312-317 (1966)].  They are similar
  120.         to cubic splines, but are less likely to introduce spurious
  121.         inflection points.
  122.  
  123.     History...
  124.         21 Sep 85    Added -xl and -yl switches for taking logs
  125.         23 Nov 85    Passing lines starting with ';' unchanged, otherwise
  126.                     ignoring them.
  127.  
  128.     Author...
  129.         Copyright (c) 1985  James R. Van Zandt
  130.  
  131.         All rights reserved.
  132.         This program may be copied for personal, non-profit use only.
  133.  
  134.         Based on algorithms by A.  K.  Cline [Communications of the ACM
  135.         v 17 n 4 pp 218-223 (Apr 74)].
  136.